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1.0 PREFACE 



The Linker is a post compilation utility by which input object 
text is processed and written to various "hardware* segment files 
which can then be loaded on the SES CY8ER 180 Simulator, The 
different object text records in a particular section are 
processed to form a set of hardware segment images. Data in the 
different segments is primarily referenced via pointers set up in 
the Binding segment which is initialized at Link time. 
Unsatisfied externals are satisfied from the specified 
I ibraries* 

Users have the option of supplying the input via an object 
fife (with/without library files) as generated by the 
compiler/assembler* or else <s)he may specify an entry point from 
a module on a specified library as the PEP parameter on the LINK 
command* and the Linker will extract the module from the library 
which contains the specified entry point and link it. 

The input to the Linker consists of CYBER 180 <C18Q) object 
modules in CYBER 180 loader text format VI. 1 generated by 
compilers and/or assemblers running on CYBER 170. 

The output of the Linker is a series of files corresponding to 
CYBER 180 hardware segments? a header file which contains the 
segment descriptor attributes for each output segment" and 
potentially an outboard symbol table file. 

Currently* the only mechanism available for taking Linker 
output and preparing it for execution in the CYBER 180 Simulator 
is the Virtual Environment Generator. It will take the segment 
files produced by the VE Linker* and build a Checkpoint File 
<CPF>. 



1.1 .SCQP£ 

This document describes the external characteristics of the J 
SES Virtual Environment Linker V2.5. The Linker is written in * 
CYBIL. ? 

This Linker is strictly intended as a transitional vehicle 
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1.1 SCOPE 



from CY8ER 170/SES to CYBER 180. It will not have a lifetime 
beyond the period of transition. 
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1*2 APPLICABLE 



The following is a list of documents that either are referred 
to in this specification or are recommended to aid in 
understanding and using this specification. 

1) SES User's Handbook <ARH 1833). 

2) ERS for Virtual Environment Generator (ARH2591). 

3) CYBER 180 Hainframe Model Independent GOS CARH 17001. 
h) ERS for Simulated NOS/VE I/O URH3125) . 

5) ERS for CYBER 180 Ob|ect Code Utilities ( ARH 2922). 

6) ERS for CYBER 180 Simulator CARH 1729). 
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1.3 LINKER V2.5 ANO LINKER V2. *» DIFFERENCES 

1) The LINKER has been converted to CY8IL compiler language. 

2> Updated to process VI. 1 of the 180 Object Text. 

3) Interface to the SES subsystem has been replaced with an 
internal linker parameter file. 
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!•*♦ OEFICIEl 



ANO LIMITATIONS 



The Linker performs only cursory checks to determine if the 
user has specified any duplicate file names in his/her 
oarameterizat ion. 

The Linker performs no checks to determine if any file names 
generated from the NAM£_SE£D duplicate any file names the user 
has specified in his/her parameterization* Therefore, the Linker 
may abort or yield indeterminate results. Hence* the user must 
resolve any file naming conflicts prior to executing the LINKER 
command* 



The Linker 
file. It uses 
an object file 
180 Assembler* 
File Utilities, 
resul ts. 



is sensitive to 

some of the data 

was generated by 

or modified with 

the Linker 



portions of the data on an object 
for computations. Therefore, if 
other than PASCAL-CI or the CYBER 
other than the CYBER 18 Object 
may abort or yield indeterminate 
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i.5 XERHXNQiqSX 

Offset linking? An optional mode of linking wherein the segments 
output by the Linker are to be loaded at addresses that are 
different than the addresses at which they will ultimately 
execute* 

Inboard symbol tables A table of resolved entry points from a 
previous linkage provided as input to the current linkage* 
Use of the inboard symbol table allows the linkage of only a 
part of the code that will actually be present when the code 
is executed* 

Outboard symbol tables A table of resolved entry points produced 
by the current linkage for inclusion in future linkages* 
Only entry points from modules possessing th^ "gated" 
attribute are included in the outboard symbol table* Use of 
the outboard symbol table allows entry definitions from the 
current linkage to be used in subsequent linkages without 
relinking the modules in which the entry points are defined* 
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2.0 ACCESSING THE LINKER 



The Linker Is accessed via an SES procedure* which is 
described in a later section. The user can control the linkage 
by specifying his parameters on the procedure call, (GENCPF or 
VELINKI* in the Linker Parameter File, or a combination of both. 
Parameters on the procedure call override the parameters 
specified in the Parameter File. 
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LINKER P£EAM£XES_FXLE gRQ. 



The Linker Parameter File ILPF> consists of a legible file built 
and maintained by an editor, LPF is an optional parameter to the 
LINK command. If one is not provided, defaults are as shown 
below. Several '•subcommands*" will be provided? LINK_OPTIONS* 
OBJECT_FIL£. 08 J£CT_LIBRARY, DEFIN£_SEGMENT, 08JEC T_M0QULE, 

IN80ARD_S¥M80L_TABLE and END. Each subcommand is entered on a 
separate line; however, continuation lines of a subcommand are 
indicated by placing two or more periods at the end of the lirve* 



UNK„Q£IIOiiS 



The LINK_0PTIONS command provides general 
parameters which establish defaults for the LINK 
one LINK_0PTI0NS command is allowed* 



mi see I laneous f 
command. Only I 



LINK_OPTIONS,&MAP_FIL£NAME=f ilename,*.. 

MAP_OPTIONS=mao_option,&REWIND_HAP,*NAHE_SEED=name_seed»$ l < 
MAX_EXTERNALS=maximum_externals,S l HEAP_SIZE = heap_size.S,. . 
PRIMARY_ENTRY_PT=primary_entry_point 



FIELD 

DEFAULT 

MAP_FIL£NAME 
LINKMAP 



MAP_0PTI0NS 
M 



DESCRIPTION 

(CHAR 7) The NOS f 
listing file on wh 
written. This pa 
(map file) paramet 
command. 

(CHm 1) The Linke 
the amount of info 
map. Values for t 

N - no map in 
output. 

S - section a 
of every 



ilename of the LINKER output 
ich the LINKER map will be 
rameter is ignored if the MF 
er is specified on the LINK 

r map options which control 
rmation output on the Linker 
his field are* 
formation; diagnostics are 

I locations for every section 
input object module 
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REWIND_MAP 

REWIND_MAP 



NAHE_SEED 
SEGH 



MAX_EXTERNALS 

300 
HEAPSIZE 





LOAD_SEGMENT 
«»0 95 

EXECUTE_SEGMENT 
*t095 



PRIMARY_ENTRY_PT 
bl anks 



E - Section allocations plus entry point I 

names and address assignments I 

M - Section allocations* entry points I 

plus output segment and common block 1 

allocations (full Linker map)* I 

IKEYHORD) The option allowing you to specify I 

whether to rewind the LINKER map file before I 

it Is written. \ 

REWINO_MAP - rewind map file t 

Nu_NAP_REWIND - don't rewind 

(CHAR k) Used as the first four 

of the NOS file names for the 

output segments, and outboard 



map file 
characters of 
header file* 
symbol table 



file* This field is Ignored if the name_seed 
parameter Is specified on the VELINK command, 
(INTEGER) The maximum number of externals 
allowed in this link. 

{INTEGER) The size in bytes of the system 
heap* IF specified* this value always takas 
precedence over the values specified in the 
input object modules* 

CINTEGER) The starting segment number for load 
load address* The linker allocates segment 
numbers consecutively. 

{ INTEGER) The starting segment number for 
execution_address. The Linker allocates 
segment numbers consecutively* If either but 
not both LOAD_SEGHENT and EXECUTE^SEGMENT are 
specified. offset loading will not be 
performed* A null specification for 
LOAD_SEGMENT or EXECUTE_SEGHENT is indicated 
by a value of **09*>* 

{CHAR 31) Primary entry point of the program 
being linked* If specified, it overides all 
transfer symbols encountered in the input 
object modules* This parameter is ignored if 
the PEP parameter is used on the LINK 
command* If not specified here or on the 
command* the first transfer symbol encountered 
is the primary entry point. 
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:iL£Z&&J££I_LIIM£X 



One 08J£CT_FIL£ command exists for each specified object file 
entry* and one OBJECT_LIBRARY command exists for each specified 
library entry* VELINK command parameters *0FL" and *LFL* take 
precedence over these commands. 

G8J£CT_FIL£* FIL£NAH£= f i I enaie, Rl=ring, R2=ring* •• 
R3=ring, GL08AL_L0CAL_KEY=key, £XECUTE_PRIVIL£G£=attr ibute 

OBJECT_LIBRARY, FILENAMES i lename, Rl=ring* R2=ring, . . 
R3=rlng, GL08AL_L0CAL_K£Y=key, £X£CUTE_PRIVIL£GE=at tribute 



FIELD 

DEFAULT DESCRIPTION 

FILENAME (CHAR 7) NOS file that name of a local file 

that 
none contains object modules* 

Rl ii (INTEGER) The ring bracket to be used for all 

R2 II object modules contained on this file. 

R3 11 
GLOBAL_LOCAL_KEY (INTEGER) The global and local key values 

to be used for all object modules contained on 

this file* 
£XECUTE_PRIVILEGE<CHAR 1) The tyDe of execute to be attribute 

to be 
E associated with all object modules contained 

on this file* Values for this field ares 
E - executable - non privileged 
L - executable - local privilege 
G - executable - global privilege 
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DEFINE SEGMENT 



One OEFIN£_SEGMENT entry exists for each Preal located Segment 
Descriptor, Either LOAD^ADDRESS or EXECUTE_ADQRESS and 

ATTRIBUTES must be specified. 

DEFINE_SEGMENT, LOAD_ADDRESS=(ring, segment, offset), .. 
EXECUTE_AODRESS=(ring, segment, of f set) , Rl=rinq, R2=ring, .. 
R3=ring, GLOBAL_LOCAL_KEY=key, ATTRI8URES= Cattr ibutes) * .. 
SECTION_NAHE=section_name 



FIELD 

DEFAULT 

LOAD_ADDRESS 




EXECUTED DDRESS 




RI II 
R2 li 
R3 11 
GL08AL_LOCALJ<EY 


ATTRIBUTES 



DESCRIPTION 

(IPL_PVA) Three comp 
segment and byte 
specifies where the 
null specification 
number of zero. 
<IPL_PVA) Three comp 
(ring, segment and 
segment* specifies 
ultimately execute. 
indicated by a rin 
L0AD_A0DRESS and E 
specified, offset 
performed. 
CINTEGER) Ring brack 



onent load address (ring, 
offset) of the segment; 
segment will foe loaded. A 
is indicated by a ring 

onent execution address 

byte offset) of the 

where the segment will 

A null specification is 

g number of zero. If both 

X£CUTE_ADDRESS are not 

loading will not be 

ets for the segment. 



CINTEGER) Global and local key for segment. 



SECTION_NAME 
b I ank s 



(CHAR 2) Segment 

of the fol lowin 

RD - read n 

RK - read c 

BI - bindin 

key/I oc 

WT - write 

WK - write 

EX - execut 

LP - execut 

GL - execut 

ET - extens 

C8 - cache 

(CHAR 31) Name o 

be mapped into t 



access at 
g attribut 
ot control 
ontrol I ed 
g* read 
k 

not contro 
control I ed 
able non p 
able local 
able a lob a 
ible 
bypass 
f Working... 
his segmen 



tributes* any number 

es can be specified. 

led by key/ lock 

by key/ t ock 

not controlled by 

lied by key/ lock 

by key /! ock 
rivi leged 

pr ivi I ege 
I privilege 



Storage sections to 

t. 
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OBJECT MODULE 

The OBJECT_MODUL£ command specifies module names to be included 
in the link. Only one 08J£CT_M00ULE command is allowed. 

08JECT_M0DULE» NAME= (mod_name* mod_name...) 

FIELD DESCRIPTION 

NAME <CHAR 3U Name(s) of modules to be included. 



INBOARD SYMBOL TABLE 

The INB0ARD_SYM80L_TABLE command specifies NOS file names which \ 

contain Inboard Symbol Tables to be introduced into the LINK. i 

Only one INB0ARD_SYM80L_TABLE command is allowed. I 

INB0ARD_SYM80L_TABLE, NAME= < f i I ename, filename...) J 

FIELD DESCRIPTION I 

NAME ICHAR 7) NOS file name<s> of files containing \ 

Inboard Symbol Tables. I 



END I 

The END command or end-of-fite signifies end of the Linker 5 
Parameter File. I 
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3.0 LlM£S-£IL£-liilIE££A££ 



The Linker Parameter File interface* described in a preceding 
section* in its most specific sense prescribes the file interface 
of the Linker. The Linker File Descriptors (LFO's) identify 
input object files and libraries by name and their associated 
attributes. The Inboard Symbol Table List (ISTL) identifies by 
name input file<s) containing inboard symbol table(s). 

NOTE* A1I files named in the LFD and IST.L must be local at the 
time the Linker is invoked. 

The Linker Control Block <LCB>* via the NAME_SE£D* specifies the 
string used by the Linker to generate names for the output filess 
header* segment* and outboard symbol table files. The Linker 
Program Descriptor (LPD) and Segment Array specifically 
identifies the header and segment files by name. 

The following sections are a brief description of the input 
files (object* library and inboard symbol table files) and the 
output files (header* segment* and outboard symbol table files). 
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3.1 SgilEd-CIlES 

The Linker accepts* as input* object files in containing 
object modules in CYBER 180 loader text format ¥1*1 generated by 
compilers and assemblers running on CYBER 170* Multiple object 
modules may reside on an object file* 

The object module structure is basically comprised of an 
Identification Record CI0R1, Section Definition Records CSOC) * 
and the object text associated with the sections* The IOR 
describes external characteristics (name* time and date created* 
version* creator* and a commentary) and internal characteristics 
(module attributes and the number of sections) of the object 
module* There is a SOC for each section type (code* binding* 
working storage* common* etc*) contained in the object module 
describing the various attributes of the section. 

The specific structure of object modules is not of general 
concern to users of the Linker* but for those who must generate 
object modules (compiler* assembler and utility writers)* a copy 
of the object module type definition may be found in Appendix A 
of this document. 
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3.2 LIBRARY FILES 



The Linker also accepts as input C180 library files containing 
ci80 object modules formatted into a library by the C160 Object 
Code Utilities. The definition of the object modules contained 
therein is the same as described in the section entitled "Object 
Files*. 

The specific structure of a library file is not of general 
concern to users of the Linker* but for those who are interested* 
the record definition may be found in Appendix A of this 
document. 
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3.3 HEADER FILE 

The Linker outputs a header file which describes the results I 
of a linkage. The name of the header file is the concatenation I 
of the NAME_SEED from the LCB with the string *HDR*. 

The header file structure is comprised of one header variant 
and a segment descriptor variant for each segment file generated 
as the result of a linkage. The header variant contains th& 
number of segment descriptors* the initial p-address and its key* 
and the binding address. The segment descriptor identifies by 
name the file on which the segment was written and its segment 
attributes. 

The specific structure of the header file is not of general 

concern to the users of the Linker* but for those who must 

interface to the header file a copy of the type definition can be 
obtained by contacting an SES representative* 
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3.* S^gHENT FILES 

The Linker outputs segment files which are acceptable as input 
to the CYBER 180 Simulator or VE Generator, A segment file 
contains a direct I/O user information record. In the context of 
the Simulator the segment file is a load file and the user 
information record is a Load File Directory of type 'empty** The 
Linker allocates and outputs a segment file for each section type 
encountered on object files during a linkage* 

The segment file structure is comprised basically of a load 
file directory and the linked segment. 

The specific structure of the segment file is not of general 
concern to the users of the Linker* A description of the file* 
however, may be found in the C180 Simulator ERS, in the appendix 
section entitled "Central Memory Format** 
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3.5 SXMS2L-I&gJLE_£IL££ 

A symbol table file is a file containing a table of resolved 
entry points from an instance of Linker execution. The file is 
termed an Inboard Symbol Table file when used as input to the 
Linker. The file is termed an Outboard Symbol Table file when it 
is output as a result of Linker execution. 

The Outboard Symbol Table COST) file is generated by the 
Linker only if entry points which have the "gated" attribute are 
encountered during a Linker execution. fOnly entry points with 
the "gated** attribute are externalized to modules in higher 
rings. This attribute is specifically assigned to a module via 
the Object Code Utility CHANGE command* > The OST file name is 
the concatentation of the NAME_SEED from the LCB with the string 
*0ST«. 

The structure of a symbol table is pertinent only to the 
Linker. 
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^•0 LI NKER HAP 



The Linker map describes the address assignments made by the 
Linker. The NOS file name* onto which the Linker map is out putt 
is specified either as a VELINK command parameter* or else in the 
Linker Parameter File. The Linker map contains four basic 
components which may be optionally listed. A sample map is 
included in a later section. 



^•i SECTION DEFINITIONS 



The following information is printed for every section of 
every object modules 

o Section type 

o Access attributes 

o Length 

o Address Uoad and execution if different) 

o Ring brackets 

o Global /I oca I key 



<*.2 £KISX.£MliUiAM£S 



The following informaton is printed for every entry points 

o name 

o address (load and execution if different! 



***3 EXTERNAL REFj 

A list of the external references is printed after the entry 
point list. 
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The following information is printed for every output segment 
allocated by the Linkers 

o NOS file name 

o Address Cload and execution if different) 

o Length 

o Access attributes 

o Ring brackets 

o Global /focal key 

The following information is printed for every common block 
allocated by the Linkers 

o Name 

o Access attributes 

o Length 

o Address (load and execution if different) 
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5.0 LINKER PROCEDURAL ! 



The following sections are also contained in the SES User's 
Handbook. 



£EttCPF - ^£ja££AILJL.£H££K£ailiI^£IL£,lll££l 

GENCPF executes the SES VE Linker and the SES VE Generator and 
produces a Checkpoint File CCPF) which can be loaded and executed 
on the CY8ER 180 system simulator. The user must provide a file 
containing 180 object text* and can optionally provide a Linker 
Parameter File <LPF)» a set of Monitor Segment files* and/or a VE 
Generator DIRective file. The "MF* file will contain the map 
produced by the VE Linker and additional information produced by 
the VE Generator. 

Notes most of the following parameters will not be used by the 
•general public* {examples show general usage). 

Parameters to GENCPF ares 



of! IFilenamefs), optional) 

ObJect_Fi le_Hst - list of up to 10 names of files 
containing 180 object text {ver 1.0). This parameter 
does not have a default. 



Ifl <Filename(s)» optional) 

LIbrary_Fi I e_L ist - list of up to 10 names of Library 
files containing 180 ob|ect text. This parameter does 
not have a default. 



pep (String(31) t optional) J 

Pr iraary_Entry__Pcint - This parameter specifies the ! 

entry point at which to start execution. The default ! 

is to start execution at the first Transfer symbol I 

encountered. I 



ns <String<M» optional) 
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Mawe.Seed - This parameter specifies th% *nate seed* 
for the VE Linker Segment files* The default for this 
parameter is *SEGM*. The value of this parameter 
OVERRIDES any Linker Parameter Fife specification of 
this field. 



mf (Filename* optional) 

Map_File - This parameter specifies the name of the map 
file. The default for this parameter is •LINKMAP*. 



mo (Char I* optional) 

Linker Map options - This parameter specifies the 
amount of information output on the Linker Hap. The 
value of this parameter OVERRIDES any Linker Parameter 
File specification of this field* Values for this 
field ares 

N - no map information* diagnostics are output* 

S - section allocations for every section of ey&ry 

input object module 
E - Section allocations plus entry point names and 

address assignments 
H - Section allocations* entry points plus output 
segment and common block allocations ffull 
Linker map) • 



rewind {Keyword* optional) 

Rewind_map_f il e - This parameter specified whether to 
rewind the Hap file before it is written* Default is 
to rewind it* The value of this parameter OVERRIDES 
any Linker Parameter File specification of this field* 
Keyword value meanings ares 

REWIND - rewind Map file 

NOREW - don"t rewind Mao file 



cpf {Filename* optional) 

Checkpoint_Fi I e - This parameter specifies the name of 
the file containing the output from the VE Generator* 
The default is 'CPFILE*. The value of this parameter 
OVERRIDES any Linker Parameter File specification of 
this field. 



Ipf {Filename, optional) 1 

Linker_Parameter_Fi le - This parameter specifies a file I 
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that contains Linker parameters that affect the Link, ! 
If no Ipf is specified, default values indicated in the 1 
LPF description apply. J 

cybilib (Keyword, optional) ! 

This parameter, when specified, will cause CYBILIB to ? 

be used to satisfy externals during the linking ! 

process. The procedure will ACQUIRE the file from SES I 

and add it to the L ibrary_.Fi I e_List . The default is I 

not to use CYBILIB as part of the Link. I 

dir or Idrdir or d {filename, optional) 

Oirectives -■ This parameter specifies the name of a 
file containing directives to the VE Generator. The 
default will be a file containing default directives. 

mtrns or mns CStringC**), optional) 

Monitor Name_Seed - This parameter specifies the 'name 

seed* of the VE Linker Segment files that contain the 

Monitor code. This parameter is provided to allow the 

user to have his own Monitor program. The default for 

this parameter is *MTRX*. The procedure will check the 

local files, the local PF catalog, and then the SES 
catalog to get the files. 

Examples* 

The following example illustrates how a user would compile a test J 
program written in CY8IL, generate a Checkpoint File, and run it I 
on the Simulator. S 

ses.cybil ci i=testprg l=testlst b=testlgo I 

ses.gencpf ofl=testlgo cpf=testcpf cybilib I 

ses.simI80 restart^ testcpf I 

? run 
? bye 

The last two lines were Simulator commands. I 

The next example illustrates how to generate a Checpoint File I 
from several input files of 180 object text. 

ses.gencpf of l=<myl gol,my lgo2) cpf=mycpf cybilib I 
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V£UUiJL^£Jl£mE THE VJEXUAJ, gMlSMMQ£2LJLlN££g 

VELINK executes the VE Linker, which links data from 180 object 
files/libraries and produces a map file and a set of SEGMent 
files. The procedure is set up so that the user can specify his 
own Linker Parameter File (LPFJ containing VE Linker variables 
that control the linkage* For^iffore information on this, refer to 
the SES VE Linker ERS <ARH2816). 

Notes this proc is generally used only in special cases* where 
GENCPF is inadequate* 

Parameters to VELINK ares 



of I (Fi lename(s), optional) 

Ob|ect_Fi le_List - list of up to 10 names of files 
containing 180 object text <ver 1*0). This parameter 
does not have a default* 



ifl (Fil ename<s), optional) 

L ibrary_Fi I e_L ist - list of up to 10 names of Library 
fifes containing 180 object text* This parameter does 
not have a default* 

pep <String<31), optional) 

Primary_Entry__Point - This parameter specifies the 
entry point at which to start execution* The default 
is to start execution at the first Transfer symbol 
encountered. 



ns (String***), optional) 

Name_Seed - This parameter specifies the 'name seed* 
for the VE Linker Segment files* The default for this 
parameter is *SEGM** The value of this parameter 
OVERRIDES any Linker Parameter File specification of 
this field* 



mf (Filename, optional) 

Map_File - This parameter specifies the name of the map 
file. The default for this parameter is "LINKMAP** 
The value of this parameter OVERRIDES any Linker 
Parameter File specification of this field* 
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mo (Char 1* optional) 

Linker Map options - This parameter specifies the 
amount of information output on the Linker Map, The 
value of this parameter OVERRIDES any Linker Parameter 
File specification of this field. Values for this 
field ares 

N - no map information? diagnostics are output. 

S - section allocations for every section of every 

input object module 
E - Section allocations plus entry point names and 

address assignments 
M - Section allocations* entry points plus output 
segment and common block allocations (full 
Linker map) • 



rewind (Keyword* optional) 

Rewind_map_f il e - This parameter specified whether to 
rewind the Map file before it is written. Oefault is 
to rewind It. The value of this parameter OVERRIDES 
any Linker Parameter File specification of this field* 
Keyword value meanings ares 

REWINO - rewind Map file 

NOREtf - don*t rewind Map file 



Ipf (Filename* optional) ! 

Linker_Parameter_Fi !e - This parameter specifies a file I 

that contains Linker parameters that affect the Link. I 

If no Ipf is specified* default values indicated in the I 

LPF description apply. J 



cybilib (Keyword* optional) 

This parameter* when specified* will cause CYBILIB to 
be used to satisfy externals during the linking 
process. The procedure will ACQUIRE the file from SES 
and add it to the LIbrary_Fi le_List. The default is 
not to use PASILIB as part of the Link. 



Examples 

In the following example the Linker is passed a Linker Parameter 
File containing the variable •mylcb*. 

ses.velink of l=( I gol f I go2) lpf=mylpf lcb=mylcb vef=myvef 
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5.1 gX^HPLL Qf tIM£S.,Rl£AHjTES^FlL£ I 

The following is an example of a Linker Parameter File. Since I 

the Linker ignores items in the list with blank or uninitialized i 

file names* this allows you to include the declaration and access I 

attribute initialization of the object file list in your command I 

file, leaving only the specification of input file name until you I 
are ready to issue the LINK command. 

I ink_optIons*map_f i tename^l ink! ist,map_opt ions=m,no_map_rewind, *» 

name_seed=l xxx,load_segment=6,execute__segment=6 I 

object_f ile,kfn=* %ri=li,r2=il,r3=ll,gl obal_local _key=0 , I 

execute_pr i vi I ege=e S 

obf ect_f ile,kfn=* %r 1=1 1 , r2=ll,r3= 11 , gl obal_ local _key=0, \ 

execute_ori vi lege=e I 

object_f ile,kfn=* • ,ri=li,r2=li,r3=ll,global_local_key=G, i 

execute_pri vil ege=e I 

ob|ect_f lie* kfn=' • ,ri=Ii,r2=Il,r3=il, glofoal__loca I _key=0, I 

execute__privi lege=e I 

def ine_segment»load_address=(ll,0,*>000) ,execute_address= (11,0, I 

**00 0) ,rl=il,r2=ll,r3=ll,global_local_key=0,attributes=(rd,ex) I 

def ine_segment, load_address=(li, 0,5000) »execute_address= (11,0, I 

5000) ,rl=ll,r2=il,r3=ll,global_local_key=0,attributes=(bi) I 

def ine_segment,load_address=( 11, 0,6000) ,execute_address= (11,0, 1 

60 00) ,rl=ll,r2=li,r3=li,globaf_local_key=0,attributes=(rd,wt) I 

def ine_segment, I oad_address=(li, 0,7000) ,execute_address= (11,0, I 

70 00) ,ri=li,r2=ll,r3=il,global_local_key=0,attributes=(rd,wt,et) J 

def ine_segment, I oad_address=( 11,0, 800 0) , execute_address= (11, 0, ? 

80 00) ,rl=ll*r2=il,r3=ll,global_local_key=9,attributes=(rd) I 
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5.2 ££AM£L£-Q£ UNKSJS ME 



The following I inkmap was produced by linking the sample 
program described in the ERS for the 180 CPU Assembler. 



LINKER V 2.5 OUTPUT LISTING 05/21/79 16,00.^6 I 

I 
MODULE = TEST LANGUAGE = CPU ASSEMBLER 

FILE = LGO 05/21/79 16*00*06.000 

i 
t 

SECTION TYPE/ LOAD/ RING 

ACCESS ATTRIBUTES LENGTH EXECUTION AODR BRACKETS G/L KEY 

WORKING~~ST6rAgI ~" ~ 

READ WRITE 28 B 000 00000000 (8,8, B> (00,00) 

WORKING STORAGE 

READ 8 B 00C 00000000 (B,B,8) (00,00) 

BINDING 

READ BINDING 10 B O0B 00000000 (B,8,8) (00,00) 

CODE 

READ EXECUTE 22 B O0A 00000000 (B,8,8) (00,00) 



ENTRY POINT DEFINITIONS ADDRESS 

ENT NOT GATED 8 00A 00000000 

LINKER V 2.5 OUTPUT LISTING 05/21/79 16.00.^6 

SES/C80 LINKER OUTPUT : LCB = LINK_CONTROL_BLK 

PCB = LINK_PC8 
LPD = LINKED_PRG_DESC 

PRIMARY ENTRY POINT = ENT1 

ADDRESS = 8 00A 00000000 

FILE NAME/ LOAD/ RING 
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ACDESS ATTRIBUTES LENGTH EXECUTION AOOR BRACKETS G/L KEY 



SEGH10I 
READ EXECUTE 

SEGM102 
BINDING 

SEGM103 

READ 

SEGM10** 
READ WRITE 



22 * O0A O00Q0O00 (8,B,8) (00,00) 



10 * OOB 00000000 (B,B,B) <GO,Q0) 



8 * OOC 00000000 CB,B,B> (00,00) 



28 * OOD 00000000 (8,8,8) (00,00) 



NO LINKER ERRORS WERE DETECTED 
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6*0 ERROR M ESSAGES 



The Linker provides two varieties of error messages SES SCL 1 
error messages describing the disposition of the command* and ! 
linker diagnostics printed on the Linker reap. 

6.1 SfiL-iSSSagES i 

Linker SCL messages conform to the SES message standards as ! 
described in the Meggage Generator CMGI Interface ERS. I 

10000 LINKER NORMAL TERMINATED I 

MEANINGS The Linker has terminated normally with I 

no fatal or nonfatal errors. J 

ACTIONS Be thankful. I 

10100 LINKER NORMAL TERMINATE WITH NONFATAL ERRORS - SEE MAP I 

LISTING i 

MEANINGS One or mora non fatal errors were 
encountered during the Linker Command. 
Linker output is probably valid. 
ACTIONS Check Linker map for diagnostic or 
diagnostics. 

10101 LINKER ABNORMAL TERMINATE - SEE MAP LISTING I 

MEANINGS The Linker has detected a fatal error and 
gracefully aborted. Linker output is 
undef ined. 

ACTIONS Check Linker map for diagnostic* correct 
problem and rerun 

10102 LINKER ABNORMAL TERMINATE - NO MODULES PROVIDED t 

MEANINGS No object module input was encountered by 
the Linker. 

ACTIONS Check th& 'off parameter on the LINK ? 
command* If specified* or else the I 
08JECT_FILE in the Linker Parameter File; ! 
check the KFN fields of all elements of J 
the object file list? check all files for 
Input. 
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10200 LI8RARY FILE file.naie NOT LOCAL 

MEANINGS File specified by the ■ I f I "parameter of 
the VELINK coitnand or the 
•GBJECT_LIBRARY* command of the Linker 
Parameter File is not a local file. 

ACTIONS Make the file local or remove the 

parameter. J 

10201 08JECT FILE f i I e_name NOT LOCAL ! 

MEANINGS File specified toy the *of I 'parameter of 1 

the VELINK command or the *08JECT_FILE - I 

command of the Linker Parameter File is I 

not a local file* I 

ACTIONS Make the file local or remove the I 

parameter. 1 

10202 OBJECT FILENAME filename DUPLICATES EXISTING FILE I 

MEANINGS Filename specified as and object file or 1 

library Cofl' or 'Ml* of the VELINK I 

command or '08JECTJFILE' or I 

•GBJECT_LIBRARy of the Linker Parameter I 

File duplicates another specifed ! 

filename. I 

ACTIONS Remove the specification of this file. I 

Make the file local or remove the I 

parameter. J 

10203 1ST FILE file_name NOT LOCAL I 

MEANINGS File specified by the I 

*INBOARD_SYM80L_TABLE "command of the I 

Linker Parameter File is not a local I 

file. I 

ACTIONS Make the file local or remove the J 

parameter. I 

1020** 1ST FILENAME filename DUPLICATES EXISTING FILE I 

MEANINGS Filename specified by the I 

•INB0AR0_SYMBQL_JA8L£* command of the I 

Linker Parameter File duplicates another I 

specifed filename. I 

ACTIONS Remove the specification of this file, I 

Make the file local or remove the I 

parameter. I 

10300 LPF FILE f i I e_name NOT LOCAL I 

MEANINGS File specified by the "Ipf parameter of I 

the VELINK command is not a local file. I 

ACTIONS Make the file local or remove the i 
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parameter. S 

10301 UNKNOWN LPF COMMAND command SPECIFIED I 

MEANINGS The Linker has detected an invalid Linker I 

Parameter File command. I 

ACTIONS Correct the Linker parameter file. I 

10302 INVALAO MAP OPTION map_option SPECIFIED I 

MEANINGS The Linker has detected an invalid map I 

option specified by the *mo" parameter of \ 

the VELINK command or "MAP_GPTIQNS* 1 

specification of the Linker Parameter I 
File *LINK_0PTI0NS* command. 

ACTIONS Correct the map option specification. I 

10303 INVALAD NAME_SEE0 xxxx SPECIFIEO I 

MEANINGS The Linker has detected an invalid name J 

seed as specified by the *ns* parameter I 
of the VELINK command or *NANE_SEE0* 

specification of the Linker Parameter I 

File "LINK_OPTIONS* command. I 

ACTIONS Correct the name seed specification. ! 

1030i» INVALAO SEGMENT ATTRIBUTE segment_at tribute SPECIFIED I 

MEANINGS The Linker has detected an invalid I 

segment attribute specified by the I 

•ATTRIBUTES* specification of the Linker I 

Parameter File "0£FINE_SEGMENT* command. I 

ACTIONS Correct the attribute specification. I 

10305 INVALAO EXECUTE PRIVILEGE execut i ve.qrivi I ege SPECIFIED I 

MEANINGS The Linker has detected an invalid J 

executive privilege specified by the I 

•EXECUTIV£_PRIVILEGE" specification of I 

the Linker Parameter File "OBJECT_FILE* ? 

or "OBJECT_LI8RARY" command. I 

ACTIONS Correct the executive privilege J 

specification. I 
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The Linker prints formatted messages on the Linker map. The 
template of all messages is as follows* 

* * * LINKER ERROR NNNNN £*FATAL*1 <error message text> 
MODULE = <module name if appropriate> 
FILE = <file name if appropriate> 
NAME * <entry point name if appropriate > 

RECORD COUNT = <record count if appropriate> 

mam lrhqr hss<?a$£ text 

i IMPROPER RELOCATION ADDRESS SPECIFICATION 

MEANINGS RIF item is being incorrectly generated? 

Linker output unaffected. 
ACTIONS Correct object text. 

2 UNANTICIPATED EOR 

MEANINGS The Linker encountered an EOR somewhere 
other than the appropriate Qn6 of an 
object module 

ACTIONS Correct object text 

3 MORE THAN ONE CODE SECTION IN A MODULE 

MEANINGS A single object module had more than one 

code section* only one is permitted. 
ACTIONS Correct object text. 

k SDO GREATER THAN IOR SPECIFICATON ENCOUNTERED 

MEANINGS The number of sections in the IOR is 
incorrect or section ordinals do not 
start at zero or are not contiguous. 
ACTION? Correct object text. 

5 CODE SECTION ATTRIBUTE SPECIFICATION ERROR 

MEANINGS Code sections must not have write or 

binding attributes. 
ACTIONS Correct object text. 

6 MORE THAN ONE BINDING SECTION PER MODULE 

MEANINGS A single object module had more than one 

binding section* only one is permitted. 
ACTIONS Correct object text. 

7 BINDING SECTION ATTRIBUTE SPECIFICATION ERROR 

MEANINGS Binding sections must not be writable or 
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executable. 
ACTIONS Correct object text. 

8 BINDING SECTION ALIGNMENT ERROR 

MEANINGS The binding section must be aligned on a 

64 bit CY8ER 180 ful) word boundary. 
ACTIONS Correct object text. 

9 DUPLICATE SECTION DEFINITION ORDINAL 

MEANINGS The same ordinal has been used for two 

sections in a single object module. 
ACTION Correct object text. 

10 BINDING ATTRIBUTE SPECIFIED FOR A NON BINDING SECTION 

MEANINGS The binding attribute may only be 

specified for the binding section. 
ACTIONS Correct object text. 

11 CONFLICTING PROTECTION ATTRIBUTE FOR COMMON BLOCK 

MEANINGS Different protection has been specified 

in separate common block declarations. 
ACTIONS Correct source program. 

12 CONFLICTING LENGTH SPECIFICATION FOR COMMON BLOCK 

MEANINGS Unequal lengths were specified ir\ 

separate common block declarations. 
ACTIONS Correct source program* 

13 COMMON TABLE OVERFLOW - RECOMPILE LINKER 

MEANINGS Linker internal table size exceeded. 
ACTIONS Call SES representative. 

l*f MISPLACED IDR OR SDC 

MEANINGS Object text structure is incorrect. 
ACTIONS Correct object text. 

15 MODULE DID NOT CONTAIN A CODE SECTION 

MEANINGS No code section encountered? Linker 

output unaffected. 
ACTIONS Correct object text if necessary. 

16 MODULE OID NOT CONTAIN A BINDING SECTION 

MEANINGS No binding section encountered? Linker 

output unaffected. 
ACTIONS Correct object text if necessary. 

17 SDOS NOT CONTIGUOUSLY NUMBERED 

MEANINGS Object text structure is incorrect. 
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ACTIONS Correct obfect text. 

18 SEGMENT TABLE OVERFLOW - RECOMPILE LINKER 

MEANINGS Linker internal table size exceeded. 
ACTIONS Call SES representative. 

19 ZEROIZE SECTION INTERNAL LOGIC ERROR 

MEANINGS Linker has aborted. 
ACTIONS Call SES representative. 

20 PROCEDURE DESCRIPTOR ALLOCATED IN NON BINDING SEGMENT 

MEANINGS Procedure descriptors that are to be used 
with the hardware CALL instructions must 
be in binding segments. 

ACTIONS Correct object text if necessary* 

21 POINTER IN BINDING SEGMENT WAS MISALIGNED 

MEANINGS Binding section entries must be right 

justified in an CYBER 180 full word. 
ACTIONS Correct object text. 

22 ATTEMPTED TO PLACE DATA IN A BINDING SECTION 

MEANINGS Binding section entries may only be 

pointers or procedure descriptors. 
ACTIONS Correct object text. 

23 LFD RING BRACKET SPECIFICATION ERROR 

MEANINGS An illegal ring number was encountered or 

Ri>R2>R3. 
ACTIONS Correct LFD entry and retry LINK command. 

2<* PREALLOCATED BINDING SEGMENT ATTRIBUTE ERROR 

MEANINGS Binding segments may not be writable or 
executable or readable under key lock 
control. 
ACTIONS Correct PSA entry and retry LINK command. 

25 PREALLOCATED EXECUTABLE SEGMENT ATTRIBUTE ERROR 

MEANINGS Executable segments may not be writable. 
ACTIONS Correct PSA entry and retry LINK command. 

26 PREALLOCATED SEGMENT RING BRACKET INCONSISTENCY 

MEANINGS The relationship R1<R2<R3 did not apply. 
ACTIONS Correct RSA entry and retry LINK command. 

27 PREALLOCATED SEGMENT ADDRESS (RING) ERROR 

MEANINGS An illegal ring number was specified. 
ACTIONS Correct PSA entry and retry LINK command. 
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28 FIRST RECORD OF AN OBJECT HOOULE HASNT AN IDR 

MEANINGS Improper object text structure or Linker 

input file was inappropriate. 
ACTIONS Correct input file. 

29 DUPLICATE ENTRY POINT WAS DETECTED 

MEANINGS A symbol has been XDCLed as an entry 
point more than once* First definition 
is used? output is unaffected. 

ACTIONS Correct object file list if necessary* 

30 LST OVERFLOW - TOO MANY ENTRY POINTS 

MEANINGS Internal table overflow - Linker must be 

recompi led* 
ACTIONS Call SES representative* 

31 EXTERNAL ARRAY OVERFLOW - TOO MANY EXTERNALS 

MEANINGS Internal Table overflow - Linher must be 

recompiled* (Maximum is 200 entries.) 
ACTIONS Call SES representative* 

32 RECORD CONTAINS IMPROPER SOO 

MEANINGS An object text record referenced an 

undefined object text section* 
ACTIONS Correct object text. 

33 INPUT RECORD CONTAINS AN IMPROPER SECTION OFFSET 

MEANINGS An object text record referenced an 
offset outside the range specified in the 
section definition* 

ACTIONS Correct object text* 

3*f NO PRIMARY ENTRY POINT ENCOUNTERED 

MEANINGS No primary entry point was specified* 
ACTIONS Declare a procedure in your PASCAL-X 
program with the "MAIN* attribute or 
place the primary entry point name in the 
PEP field of the PCS. 

35 PRIMARY ENTRY POINT NOT XDCLED 

MEANINGS The name encountered by the Linker for 

the primary entry point was not XOCLed in 

any object module encountered in the 

I inkage* 
ACTIONS Declare a procedure in your ISWL program 

with the *XDCL" attribute. 
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36 



OBJECT FILE 

MEANINGS 

ACTIONS 



37 



38 



NO OBJECT FILE INPUT 

No object module input was encountered by 
the Linker. 
Check the 03J__FILE_LIST parameter on the 
LINK command if specified, or else the 
PCB.08J_FILE_LIST_NAME for an LNS name? 
check the KFN fields of all elements of 
the object file list? check all elements 
of the object file list* check all files 
for input. 

UNSATISFIEO EXTERNAL REFERENCE 

MEANINGS AnXREFed declaration was not XOCLed in 

any module encounterd in the I inkage* or 

on any of the modules on the specified 

I ibraries. 
ACTIONS Check input file list to assure that you 

specified all the files you intended to? 

check your program for a missing *XDCL*. 

LFO CONTAINS IMPROPER EXECUTE ATTRIBUTE 

MEANINGS Unknown execute attribute was specified 

in LFO. 
ACTIONS Correct LFO and retry LINK command. 



39 



<*0 



41 



42 



UNKNOWN OBJECT TEXT RECORD TYPE 

MEANINGS Object text structure 
ACTIONS Correct object text. 



is incorrect. 



UNKNOWN EXTERNAL REFERENCE INSERTION TYPE 

MEANINGS Object text structure is correct 
ACTIONS Correct object text. 



UNKNOWN SECTION DEFINITION TYPE 

MEANINGS Object text structure 
ACTIONS Correct object text. 



is correct. 



43 



RIF DOES NOT PERTAIN TO CODE OR BINDING SECTION 

MEANINGS Relocation information is being 
incorrectly generated. Linker output is 
unaffected. 
ACTIONS Correct object text. 

IMPROPER RELOCATION CONTAINER SPECIFICATION 

MEANINGS Relocation information is being 
incorrectly generated* Linker output is 
unaffected. 
ACTIONS Correct object text. 
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44 EXPECTED SCO RECORD 

MEANINGS Object text structure is incorrect, 
ACTIONS Correct object text, 

45 INVALID PROCEDURE OFFSET FOR. INDIRECT CALL 

MEANINGS The procedure offset for an indirect call 
is not mod 8. To facilitate "binding"* 
procedure offsets for indirect calls 
should be mod 8, 

ACTIONS None necessary at this time* but the 
object text generator should be modified 
to allocate all procedures on a word 
boundary, 

46 INVALID SIT STRING INSERTION RECORD 

MEANINGS The Linker encountered a bit string 
insertion record with a bit offset 
greater than 7 or bit length greater than 
57, No bit string insertion has taken 
place* 

ACTIONS The object text generator has caused the 
error and must be corrected, 

47 BAD LIBRARY FORMAT 

MEANINGS A file in the Library File List was not a 
recognizable ISO Library created by the 
SES CYBER 180 Object Code Utilities. 

ACTIONS Review the Libraries specified in the 
•Library File Lisf. 

48 REQUIRED LIBRARY MISSING 

MEANINGS The Linker encountered a Libraries record 
that specified a library that was not 
present in the 'Library File List*, 

ACTIONS ACQUIRE the library and specify it in the 
"Library File Lisf. 

49 ERROR IN PARAMETER VERIFICATION 

MEANINGS The type declarations for the variable do 
not match on the XDCL and the XREF, 

ACTIONS Check the type declarations for the 
variable* they must be word for word. 
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A 1.0 $£$/C18Q Q9J£CT-I£XT FpSa&I 



C 

C 

C The general form of an object module is a file of binary records 

£ with the following topology? 

C 

£ < object text descriptor # 1 > 

C < object text record # i > 

€ < object text descriptor # 2 > 

£ < object text record # 2 > 

c • • » 

C < object text descriptor # n > 

£ <object text record # n > 

£ 

C For the sake of simplicity the record descriptor - record pairs 

£ will be referred to as records hereafter. 

£ 

£ For a CPU program* the object text records must be arranged in 

£ the following order: 

£ 

£ 1). Identification record 

£ 2.) Library, section definition, text, bit string insertion, 

£ address formulation, external linkage, entry definition, 

£ relocation, formal parameter specification, actual 

£ parameter specification and binding template records in 

£ arbitrary order with the one stipulation that a section 

£ definition record must precede any other object text 

£ records that refer to the section. 

£ 3). Transfer symbol record* 

£ 

£ For a PPU program or overlay, the object text records must be 

£ arranged in the following orders 
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C 

C i.) Identification record 

C 2.) FPU absolute record 

C 
£ 

* 
C Constants that pertain to both the object and load module. 1 

CONST 1 

! lc$max_adr_£ terns = 0ffff(16>, i 

lic$iBax_ext_ite!BS = 0ffff<16>, ? 

Hc$ff?ax_tlbraries = 0ffff(16), I 

Hc$max_rel_iten?s = 0ffffll6>* i 

Hc$raax_section_ordinal = 0ffffCI6> - 1? \ 

TYPE 

II tSob] ect__text_descriptor = record 

case kind: f I t$obj ect_record_kind of I 
= I lc$identi f ication, I lc$sect ion_def init ion, II c$bi t_string_insertion, J 

I lc$entry_def ini tion, I lc$binding_terapl ate, I f c$transfer_symbol , \ 

oct$i ibrary^header = I 

unused? ost$segf8ent_o f f set, Craust be zero} 

« 1 1 c$l ibraries = I 

nu»Bber_of_l ibrariess I •• I I c$max_l ibraries* % 

= llc$text, I lc$repl ication = I 

nuiaber_of _bytess i *• osc$max__segment_ length, I 

« Hc$relocation = I 

nufflber_of _re I litems s i •• I I c$niax_rel__iteras» J 

= Hc$address_f orreulat ion = I 

number_of _adr_iteras: i .. I lc$raax_adr_items» t 

= I lc$external_l inkage = i 

number_of _ext_.it eras s i ., I lc$max_ext_items, I 

= I tc$f ormal_parameters, I lc$actual ..parameters = \ 

sequence^! engtht ost$segnjent_length, CREP sequence_l ength OF CELL.} 

= Mc$ppu_absolute = I 

nu»ber_of_*tords* II t$ppu_address, \ 

= oct$raodul e_directory, oct$entry_point_directory = S 

number_of_directory_en tries? integer, 
casend, 
recend* 

TYPE 

1 lt$ob| ect_record_kind = (I IcSidenti f ication, H c$l ibraries, J 

I lc$section_def inition, I IcStext, I IcSrepI icat ion, 
I lc$bit_string_lnsertion, I ic$entry_def init ion, 1 1 c$re location, 
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I lc$address_f ormulat ion* I lc$external_l inkage* I lc$f ori8al_paraietersi 
I lc$ac tual_paraiaeters» 1 1 c$binding_te?apl ate* I lc$ppu_abso I ute* 
ficlreserved.li I I c$reserved_2, I lc$reserved_3* Hc$reserved3» 
I lc$transf er^symbo l» oct$ I ibrary__header<t octSmodul e_directory» 
oct$entry_point_directoryl ; 

TYPE 

I ItSidentif ication = record 
names pmt$prograni_naflie* 

obJect_text_version: string <M» C *V1.1* 3 
kinds i lt$ffiodule_kind» 
tiree_createds ost$tirae» 
date_createds ostSdate* 
attributes* I ItSisodule.at tributes* 
greatest_section_ordinal s 1 1 t$sect ion_ordinal 9 
generator_id$ 1 I t$raodule__generator* 
generator_nafae_verss string {«>0}» 
commentary? string <**0)* 
recendt 

I I t$f&odule_kind = ( I lc$mi_v irtua Instate* I lc$vector_virtual_state«. 
I Icfiou) ; 

TYPE 

I It$fliodule_generator = (l!c$algol* llcSapl* I lc$basic, llclcobol, 
I IcSassembl er» llc$fortran* Hc$ob J ect_J lbrary_generator t 
I lc$oascah llc$cybii* Hc$pl_i* llc$syropl)» 

I I tSraodul e_attributes = set of i I lc$nonblndabl e, i IcSnonexecutabl e) ; 



TYPE I 

Mt$l ibraries = array t * 1 of amt$l ocal_f i le_name? 1 

* 

TYPE I 

Mtfsect ion_de f inition = record I 

kinds I I t$section_kind» ? 

access__attributess I I t$section_access_at tributes* I 

section_ordinal s I I t$sect ion_ordinal * \ 

lengths ost$segmen t_length» \ 

al location_a I ignments ost$segment_of fset * \ 

al location_o ffsets ost$segment_of f set, I 

names pmt$program_name* I 

recendt I 

4 
4 
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1 1 tfsect ion_ordinal = • • 1 lc$raax_section__ordinai , 
Ht$section_of fset = •• osc$raaximun*_of fset * 

TYPE 

I it$section_kInd = I Hc$code_section, I lc$binding_sect ion» 
I lc$**orking_stor3ge_ section* I !c$co?iHiion_block, 
I lc$extensib le_working_storage* 1 1 c$extensible_common_btock, 
I IcSinvai id_section) , 

lltS sect ion_access__at tributes = set of <ilc$read» HcSwrite* HcSexecute, 
I lc$binding) ? 

C Text record. > 

TYPE 

I $ t$text = record 

section^ordinal s I It$section_ordinal , 
offsets I I t$section_of f set, 
bytes array t * ] of •• 255, 
recend* 

C Replication record. J 

TYPE 

Utfrepl ication = record 

sect ion_ordinal s I I t$sect ien_ordinal , 
offsets II t$section_of f set, 
increments 1 ,• osc$max_segment_length, 
counts 1 •• osc$fflax_seg?nent_Iength, 
byte? array C * 1 of •* 255, 
recend* 

C Bit insertion record. > 

TYPE 

I lt$bit_string_insertion = record 

sect ion_ordlnal s I I t$sect ion_ordinal , 
offsets I I t$section_of f set, 
bit_offsets .. 7, 
bit__ lengtns 1 •» 63, 

bit_strings packed array CI •• 633 of •• I, 
recend? 



C Address formulation record. 1 



COMPANY PRIVATE 



CDC - SOFTWARE ENGINEERING SERVICES 
ERS for SES Virtual Environment LINKER 
Ai*0 SES/C189 OBJECT TEXT FORMAT 



Al-5 
G2/15/S0 



REVS G 



TYPE 

I I t$address_formulat ion = record 

value_sections 1 1 t$sect lon_ordinal , 
dest_sections 1 I t$section_ordinal , 

items array t * 1 of I I t$address_f ormulat ion_i tem, 
recend, 

II t$address_formulat ion_i tern ~ record 

kinds I lt$internal_address_kind, 

value_of f set s I I t$sectlon_of fset, 

dest_offsets 1 1 t$section_of f set, 
recend, 

I I t$address_kind - (llcSpva, I Ic$internai_proc, Hc$one_word_externa I 
I lc$externai_proc, I lc$address_addit ion, I lc$address_subtraction) , 



.proc s 
I 



I I t$internal__address_kind = I lc$pva 



I lc$external_proc* 



C External reference record* > 

TYPE 

I I t$external_l inkage = record 
names pmt$program_naine, 
languages I I t$raodule_generator, 
dec I aration_matching_requireds boo! ean, 
declaration_matching_values integer, 
items array t * 3 of 1 1 t$external_l inkage_i tern, 
recend, 

I I tSexternal_l lnkage_item = record 

sect ion_ordinal s I I t$sect lon_ordinal , 

offsets | | t$section_of f set, 

kinds l I t$address_kind, 

of f set_operand8 ost$segment_of fset, 

recend* 



C Entry point definition record* 1 

TYPE 

H t$entry_def inition = record 

sect ion_ordinal s I I t$sect ion_ordinal , 
offsets t I t$section_of f se t, 
attributes* I I t$en try_point_attributes, 
names pmt$prograta_narae» 
languages I I t$module_gener3tor, 
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dec! aration_matching_requireds boolean, S 

decl aration_matching_values integer, I 

recendi ** 

« 

i lt$entry_polnt_attributes = set of ( I lc$retain_entry_point , J 

I lc$gated_entry_point) * I 

* 

i 

TYPE f 

I ItSrelocation - array f * I of I I tSretocat lon_i tet, I 

1 
I lt$relocation_item = record S 

sect ion_ordinal i I lt$secticn_ordinal , \ 

offsets ff t$ sect! on_off set, I 

relocating_sect ions I) t$section_ordina I * I 

containers if t$re» ocation_container, \ 

addresss II t$address_tyoe, I 

recend, I 

J 

1 lt$relocation_container = CUc$parcel, t I c$three_by tes, I IcShal f uord, 1 

McSword, tlc$d_field, llc$q_field, llc$ 1 ong_d_f ie 1 d) , J 

< 

I J t$address_type = 111 c$by tempos I five, I lc$oarcel_posi t i ve, I 

I IcShal f*iord_posit ive, I lc$*ord__positive, I I c$byte_signed, J 

I I c$parcel_signed, 1 lc$ha I fword_signed, I lc$word_signed) ; S 

I 

t 

C Procedure formal parameter description record. > I 

I 

TYPE I 

I I t$foriaal_parameters = record * 

procedure_name* pmt$program_name, I 

specifications SEQ < * ), I 

recend* I 

I 

* 

C Procedure call actual parameters record. > I 

I 

TYPE 1 

t lt$actual_parameters = record J 

cal Iee_name8 prat$program__name, I 

languages 1 1 t$module_gener3tor f I 

I ine_number_of_cal I s 1 1 t$source„l ine^umber, I 

specifications SEQ < * >, I 

recend, ! 

I 
I I t$source_l ine_number = string (18)* S 
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I 
C FORTRAN argument descriptions used to describe a single actual or > I 

C formal parameter- J I 

TYPE J 

II t$f ortran_argument_desc = record I 

argument_types llt$f ortran_argument_type, I 

string_lengths 1 1 t$f ortran_string_length, C only used for type CHAR} \ 

argument_kinds 1 1 t$f ortran_argument_kind, I 

array_s£zes I I t$f ortran_array_size, C only used for kind DIMENSION} I 

modes 1 1 t$argument_usage, \ 

recend, I 

• 

I I t$fortran_argument_type = C I lc$fortran_l ogical * I lc$f ortran_integer, I 

I lc$fortran_real * I lc$f ortran_doubl e — real , I lc$f ortran_complex* I 

I lc$fortran_char, I lc$f ortran_boolean, I lc$f ortran_nul l_type) , % 

■ 

II tSf ortran_string_l ength = record I 

adaptable: boolean-* I 

numbers .. 0ffff(i6), I 

recend, I 

* 

I lt$f ortran_argument_kind = < I lc$f ortran__simple_variabl e, I 

I lc$f ortran_dimens ion* I left ortran_ external » I 

I lc$fortran_subscripted_var) , I 

* 

* 

II t$f ortran_array_size = record I 

adaptable: boolean, 3 

dimensions ost$segment_length* I 

recend, I 

I 
I lt$arguraent__usage = < I lc$argument_written» I lc$argument_not_written) * J 

I 

TYPE J 

I ltSbinding_template = record I 

binding_of fsets I I t$section__of f set, I 

case kinds I I t$binding_temol ate_kind of S 

= I lc$current_module = I 

section_ordinals I I t$section_ordinal , 3 

offsets l l t$section_of f set, J 

internal_addresss I | t $internal_address_kind, I 

= II c$external_ref erence = I 

names pmt$program_name, I 

addresss I I t$address_kind, J 

casend, I 

recend* I 

I 
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TYPE 1 

I !t$bindinq_template_kind = U lc$current_modul e, i lc$externa!_ref erence)* f 

J 

TYPE I 

1 1 t$transfer_symbol = record ! 

names pmt$program_name, I 

recend* I 

TYPE 

M t$ppu__absof ute = record 

executes_on_any_ppyS boolean, 
ppu_numbers o •• 1 1 c$raax_ppy_nu»ber, 
load_addresss I I t$ppu_address, 
entry_addresss 1 1 t$ppu_address, 
texts arrayt » ! OF .. QffffUS), 
recend; 

I 
C library header record 

TYPE 

I I t$l ibrary^record = record 

naie* pmt$program_name, tname of I ibrary 

time_createds ost$time, 

date_createds ostSdate, 

modul e_direc tory_index5 integer, 

entry_point_directory_indexs integer, 
recend* 

Cmodule or entry point directory record 

TYPE 

I it$directory_item = record 

names pmt$program_name, Cname of module or entry point 
module_sizeS integer, Csize of module (170 words) 
module_indexs integer, {random index of module 
recend* 
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